Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 3 - Text Encoding Converter Reference / Text Encoding Converter Functions

Internet and Regional Text Encoding Names /

TECGetTextEncodingFromInternetName

Returns the Mac OS text encoding specification that corresponds to the specified Internet encoding name.

pascal OSStatus TECGetTextEncodingFromInternetName (
                     TextEncoding *textEncoding,
                     ConstStr255Param encodingName);

textEncoding

A pointer to a text encoding specification. On output, the structure contains the Mac OS text encoding specification that corresponds to the Internet name specified by the encodingName parameter.

encodingName

A character string holding the Internet encoding name, in 7-bit US ASCII.

function result

A result code. See "Text Encoding Conversion Manager Result Codes" (page 42) for a list of possible values.

DISCUSSION

The Internet uses names (strings) to identify Web or mail encodings, while the Text Encoding Converter uses numeric text encoding specifications. You use TECGetTextEncodingFromInternetName to obtain the text encoding specification for a text encoding whose Internet encoding name you provide. This function performs the opposite action of TECGetTextEncodingInternetName (page 77).

SEE ALSO

The function GetTextEncodingName (page 52)